package com.ruoyi.play.service;

import java.util.List;
import com.ruoyi.play.domain.WhereToGoUserChoice;

/**
 * 用户选择记录Service接口
 * 
 * @author ruoyi
 * @date 2024-12-19
 */
public interface IWhereToGoUserChoiceService 
{
    /**
     * 查询用户选择记录
     * 
     * @param id 用户选择记录主键
     * @return 用户选择记录
     */
    public WhereToGoUserChoice selectWhereToGoUserChoiceById(Long id);

    /**
     * 查询用户选择记录列表
     * 
     * @param whereToGoUserChoice 用户选择记录
     * @return 用户选择记录集合
     */
    public List<WhereToGoUserChoice> selectWhereToGoUserChoiceList(WhereToGoUserChoice whereToGoUserChoice);

    /**
     * 根据用户ID查询选择记录
     * 
     * @param userId 用户ID
     * @return 用户选择记录集合
     */
    public List<WhereToGoUserChoice> selectWhereToGoUserChoiceByUserId(Long userId);

    /**
     * 根据模块ID查询选择记录
     * 
     * @param moduleId 模块ID
     * @return 用户选择记录集合
     */
    public List<WhereToGoUserChoice> selectWhereToGoUserChoiceByModuleId(Long moduleId);

    /**
     * 新增用户选择记录
     * 
     * @param whereToGoUserChoice 用户选择记录
     * @return 结果
     */
    public int insertWhereToGoUserChoice(WhereToGoUserChoice whereToGoUserChoice);

    /**
     * 修改用户选择记录
     * 
     * @param whereToGoUserChoice 用户选择记录
     * @return 结果
     */
    public int updateWhereToGoUserChoice(WhereToGoUserChoice whereToGoUserChoice);

    /**
     * 删除用户选择记录
     * 
     * @param id 用户选择记录主键
     * @return 结果
     */
    public int deleteWhereToGoUserChoiceById(Long id);

    /**
     * 批量删除用户选择记录
     * 
     * @param ids 需要删除的数据主键集合
     * @return 结果
     */
    public int deleteWhereToGoUserChoiceByIds(Long[] ids);

    /**
     * 记录用户选择（包含更新选项热度值）
     * 
     * @param userId 用户ID
     * @param moduleId 模块ID
     * @param optionId 选项ID
     * @param ipAddress IP地址
     * @param deviceInfo 设备信息
     * @return 结果
     */
    public int recordUserChoice(Long userId, Long moduleId, Long optionId, String ipAddress, String deviceInfo);
} 